home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sffcttrv.zip / SFFCTTRV.DOC < prev    next >
Text File  |  1990-09-22  |  18KB  |  410 lines
  1.                                  
  2.                                 SFFCTTRV
  3.                      SPITFIRE TRUE FACTS TRIVIA DOOR
  4.                                    by
  5.                               Dr. Feelgood
  6.  
  7.                                                              
  8.     
  9.     
  10.    INTRODUCTION
  11.    ------------
  12.                          
  13.       SFFCTTRV is a fascinating fact-filled trivia game designed to run
  14.    as a door feature within the SPITFIRE Bulletin Board System.  It can
  15.    also be installed as a sysop configurable command from the Main, File
  16.    or Message menus of SPITFIRE.  A data file containing 500 fascinating 
  17.    trivia questions is randomly accessed and displayed to the screen.  
  18.    With each question that is displayed, four multiple choice options 
  19.    are provided from which the player may select.  SFFCTTRV allows the 
  20.    player ten seconds to read the question and respond with the number 
  21.    corresponding to the answer they wish to select.
  22.     
  23.     
  24.    SFFCTTRV SETUP AS A SPITFIRE DOOR
  25.    ---------------------------------
  26.     
  27.       To set up SFFCTTRV to be executed as a door, it is recommended that
  28.    a separate directory be set up for it.  For explanation purposes, let's
  29.    assume the directory DOORA is created for use with SFFCTTRV.  The following
  30.    files must then be placed in the directory:
  31.    
  32.    SFFCTTRV.EXE    The actual game program.
  33.    
  34.    SFFCTTRV.DAT    The data file containing the trivia questions.
  35.    
  36.    SFFCTTRV.TOP    This is a listing of the top ten players.  SFFCTTRV.EXE
  37.                    will create this file if it is not found. 
  38.                    
  39.    SFFCTTRV.LMT    This allows you to set time limits according to the
  40.                    callers security level.
  41.    
  42.    The Sysop will then need to use a text editor to edit the SF.BAT file   
  43.    as illustrated below:
  44.    
  45.    :DOOR_A
  46.    COPY SFDOORS.DAT C:\SF\DOORA
  47.    CD \SF\DOORA
  48.    SFFCTTRV
  49.    ERASE SFDOORS.DAT
  50.    CD \SF
  51.    GOTO LOOP
  52.    :DOOR_B
  53.      
  54.    You will notice that the commands needed to execute SFFCTTRV are placed
  55.    between the :DOOR_A and GOTO LOOP command lines.  These are entered in
  56.    place of the existing REM Place Program Name Here.  The following will 
  57.    briefly explain each of the commands which were set up within SF.BAT to 
  58.    run SFFCTTRV as a SPITFIRE Door program:
  59.    
  60.       SFDOORS.DAT is created automatically by SPITFIRE when a user enters a
  61.    door.  It contains information about the user such as name and password.
  62.    SFFCTTRV requires access to the information within SFDOORS.DAT.  Therefore,
  63.    before executing the program it must be copied to the directory in which
  64.    SFFCTTRV is running.  
  65.    
  66.       SFFCTTRV is the program name and executes the game program from within
  67.    the door program.
  68.    
  69.       Once the user has terminated the game play of SFFCTTRV, SPITFIRE
  70.    erases the SFDOORS.DAT file.
  71.    
  72.    Before trying the door, the sysop needs to edit the SFDOOR.MNU in the main
  73.    SPITFIRE directory showing this fascinating fact trivia door and the 
  74.    minimum Security level needed to enter it, like so:
  75.  
  76.    Fascinating Facts Trivia,10
  77.  
  78.    In addition, the files included with this package include TWO screen
  79.    displays which will show when the user FIRST enters your door. They are
  80.    called SFDOORA.CLR and SFDOORA.BBS, change the letter A to match the letter
  81.    corresponding to your door and place BOTH of these files in your display
  82.    area. Most are called C:\SF\DISPLAY.
  83.     
  84.    SFFCTTRV SETUP AS A SYSOP CONFIGURABLE COMMAND
  85.    ---------------------------------------------
  86.  
  87.       SPITFIRE has a sysop configurable command for the Main, Message and
  88.    File menus.  The sysop configurable command is executed through a
  89.    batch file which corresponds to the menu it is being run from.  In
  90.    other words, SFMAIN.BAT runs the sysop configurable command from
  91.    the Main Menu, SFMESS.BAT runs the one from the Message Menu and
  92.    SFFILE.BAT the one from the File Menu.  The commands necessary
  93.    to execute SFFCTTRV can be set up in the batch file which corresponds
  94.    to the menu you wish to have SFFCTTRV run from.
  95.  
  96.       The first thing you will need to establish is which of these menus
  97.    you wish to use to run SFFCTTRV.  For this purpose, let's assume that
  98.    it is going to be set up so it can be run from the Main Menu.  (It
  99.    should be noted the set up procedure is the same regardless of which
  100.    Menu you are running SFFCTTRV from.)
  101.  
  102.       Next, you will need to decide what you wish to name the command
  103.    option and establish what security level will be required for
  104.    users of your system to be able to access this option.  Once this
  105.    is determined you will need to modify the SFMAIN.MNU file using
  106.    your favorite text editor, as long as it saves in ASCII format.
  107.    (Refer to the SPITFIRE manual for further documentation on this
  108.    if needed.  It should also be noted that if SFFCTTRV were being
  109.    set up to run from the File Menu, you would need to modify the
  110.    SFFILE.MNU file and if it was being set up to be run from the
  111.    Message Menu you would need to modify the SFMSG.MNU file.)
  112.  
  113.  
  114.       Examining the default SFMAIN.MNU file, you will notice the sysop
  115.    configurable command appears as:
  116.  
  117.         <K>. Fascinating Facts Trivia,,1000,@
  118.  
  119.  
  120.       This will need to be replaced with a Command Character that will
  121.    be used to select the option from the menu.  It is ASOLUTELY IMPERATIVE
  122.    that the Command Character must not duplicate an existing Command
  123.    Character for another menu option.  You will then need to include
  124.    a brief description of the SFFCTTRV door program you are running, two
  125.    commas, the security level required to access this feature, and another
  126.    comma followed by the a @.  The @ must not be changed! (For more detailed
  127.    information on modifying your SFMAIN.MNU, SFMSG.MNU or SFFILE.MNU refer
  128.    to your SPITFIRE manual.)
  129.     
  130.        <K>.... Brief Program Description,,10,@
  131.  
  132.       Now you will need to modify the corresponding batch file, SFMAIN.BAT,
  133.    so that it can be executed from the Main Menu.  Do this using your
  134.    favorite text editor, as long as it saves in ASCII format.  (Again, it
  135.    should be noted that if SFFCTTRV were being set up to run from the File
  136.    Menu, you would need to modify the SFFILE.BAT file and if it was being
  137.    set up to be run from the Message Menu you would need to modify the
  138.    SFMESS.BAT file.)
  139.  
  140.       Place the SFFCTTRV.EXE file in the directory you wish to run the
  141.    program from.  SFFCTTRV will create its own player score file,
  142.    SFFCTTRV.TOP, if does not already exist.
  143.  
  144.       The commands set up in the SFMAIN.BAT file are very similar to
  145.    those used for executing the game through a door in the SF.BAT file.
  146.    For instance, if you were running SFFCTTRV from the main SPITFIRE
  147.    directory your SFMAIN.BAT file might look like this:
  148.  
  149.        ECHO OFF
  150.        BRK OFF
  151.        SFFCTTRV
  152.        BRK ON
  153.  
  154.       (BRK is not included in the SFFCTTRV package because it is written
  155.    and copyrighted by Solid Systems, 1985, but can be downloaded from
  156.    "HOME" BBS at 714-735-2573 and Buffalo Creek's BBS as well as a number of 
  157.    other BBS systems.  BRK is not required to run SFFCTTRV, however, it 
  158.    is recommended since it will prevent a user using the CTRL BRK command 
  159.    to terminate the batch file, gaining access to your system at the 
  160.    DOS level.)
  161.  
  162.       If you wish to set SFFCTTRV up in a separate subdirectory from
  163.    SPITFIRE, for instance, a subdirectory named SFFCTTRV, your batch
  164.    file might look like this.
  165.  
  166.        ECHO OFF
  167.        BRK OFF
  168.        COPY SFMAIN.DAT \SF\SFFCTTRV
  169.        CD \SF\SFFCTTRV
  170.        SFFCTTRV
  171.        ERASE SFMAIN.DAT
  172.        CD \SF
  173.        BRK ON
  174.  
  175.  
  176.       When SFFCTTRV is executed, from either the door with the SF.BAT file
  177.    or from the sysop configurable command through a menu with the
  178.    corresponding batch file, it will first look for the SFMAIN.DAT file,
  179.    then the SFMESS.DAT file, then the SFFILE.DAT file and lastly the
  180.    SFDOORS.DAT file.  It will look for each of these files until it finds
  181.    it and the commands required for its execution.  If none of these
  182.    files are found, SFFCTTRV will halt its execution.
  183.    
  184.   
  185.    TRUE FACTS TRIVIA HIGH SCORE BULLETINS
  186.    --------------------------------------
  187.    
  188.       A command line parameter is available which will automatically
  189.    create Ansi and Non-Ansi high score bulletins for your BBS system.  
  190.    If you would like to use this option, a "/P" should follow the 
  191.    SFFCTTRV in the command line to indicate a valid DOS path where the 
  192.    bulletin file will be created.   (NOTE:  This should be the same
  193.    as the display file path you have set up within SPITFIRE.)  The path 
  194.    is then followed by the file name of the bulletin to be created.  It 
  195.    is not necessary to include the file extension.  SFFCTTRV will 
  196.    automatically add a .BBS extension for the Non-Ansi display file and 
  197.    a .CLR extension for the Ansi display file created.  The correct 
  198.    syntax should look like this:
  199.    
  200.    SFFCTTRV /P C:\SF\DISPLAY\DORBUL1
  201.    
  202.    The "/P" command line is optional and SFFCTTRV will operate perfectly
  203.    fine without it.  However, it is a convenient means of providing and 
  204.    posting high score bulletins for the fascinating facts trivia door.
  205.    
  206.  
  207.    LOCAL PLAY OF SFFCTTRV
  208.    ----------------------
  209.  
  210.       It should also be noted that a Sysop can play SFFCTTRV locally by       
  211.    entering the following command at the DOS prompt:
  212.    
  213.    C:>SFFCTTRV /L
  214.  
  215.     
  216.     ** SPECIAL NOTE **  The "/L" and the "/P" command parameters can
  217.     be used together in one command line to specify the drive, path
  218.     and filename of the bulletin to be created when playing in
  219.     local mode.
  220.  
  221.  
  222.    DTE LOCK FEATURE
  223.    ----------------
  224.  
  225.       SFFCTTRV automatically detects if the DTE is locked at 19200 baud.  If
  226.    SFFCTTRV detects that the DTE is locked, then SFFCTTRV opens the serial
  227.    port to the maximum baud rate of your system.  If SFFCTTRV does not 
  228.    detect that the DTE is locked, then the serial port is opened to the
  229.    baud rate of the caller.
  230.    
  231.  
  232.    SYSOP FEATURES
  233.    --------------
  234.    
  235.        First, a status line is now displayed on the BBS monitor that 
  236.    provides information concerning the caller's name, baud rate of the 
  237.    caller and the security level of the caller.     
  238.    
  239.       A SFFCTTRV.LMT file allows the sysop to establish a time limit for 
  240.    door play according to the security level the caller has on the system.  
  241.    To modify the accompanying SFFCTTRV.LMT file, use your favorite text 
  242.    editor to represent the various security levels you have available on 
  243.    your system, a comma then the corresponding time you wish to allow for 
  244.    that particular security level in minutes.  For instance, it might 
  245.    look like this:
  246.    
  247.    10,15
  248.    25,20
  249.    50,25
  250.    999,30
  251.    
  252.    Each security level should begin a new line and you should have a
  253.    setting for each security level you have available on your system.
  254.    If you do not have a time limit set for a particular security 
  255.    SFFCTTRV will default to the level 10 security level setting.
  256.    
  257.       Pressing the Shift Key and the F1 key simultaneously will 
  258.    terminate game play of SFFCTTRV and return the caller back to the
  259.    BBS.  Pressing the Shift Key and the F9 key simultaneously will
  260.    terminate game play of SFFCTTRV and log the caller off of the BBS.
  261.    If the Shift Key and the F9 key are pressed together, logging the
  262.    caller off the BBS, SPITFIRE will recycle and return to the
  263.    SPITFIRE Ready For Caller Prompt.   
  264.             
  265.  
  266.    SFFCTTRV EXECUTION
  267.    ------------------
  268.       
  269.       When first executed, SFFCTTRV will display a list of the Top Ten 
  270.    high score players and the percentage of correct responses they acheived
  271.    while playing SFFCTTRV.  Initially, this will be a dummy listing with
  272.    ten lines that display:
  273.    
  274.       0%...............YOUR NAME COULD BE HERE
  275.       
  276.    However, as the game is played, this will fill with the name of the
  277.    players, their percentage ratings and the date that the player was
  278.    added to the top ten listing.  
  279.    
  280.    NOTE: At least twenty questions must be attempted before SFFCTTRV will
  281.          will figure the percentage rating for the player.
  282.          
  283.    To keep things interesting...the Sysop can erase the file which contains
  284.    the top ten listings SFFCTTRV.TOP on a routine basis to give additional
  285.    players a chance to have their name added to the list.
  286.    
  287.    As the top ten list is displayed, at the bottom of the screen  is a
  288.    question which prompts the user whether they want to have ANSI Graphics
  289.    (y/n)? available to them during game play.  If the user responds with a
  290.    y (for yes) the game will display in color and if the user responds with
  291.    a n (for no) the game will display in monochrome.
  292.    
  293.    
  294.   
  295.    PLAYING SFFCTTRV
  296.    ----------------
  297.   
  298.       Immediately after pressing any key (other than <Q> for Quit) from 
  299.    the Top Ten listing the game screen is displayed.  The screen will
  300.    look like the following:
  301.       
  302.    ------------------------------------------------------------------------
  303.  
  304.     ╔═════════════════════════════════════════════╗
  305.     ║   >>>>>>>>>> TRUE FACTS TRIVIA <<<<<<<<<<   ║
  306.     ║                 Version 1.0                 ║
  307.     ║   Trivia Door Game For SPITFIRE BBS Doors   ║
  308.     ║          "Home" BBS (714) 735-2573          ║
  309.     ║ In Cooperation with Buffalo Creek Software  ║
  310.     ║     Copyright (C) by Dr. Feelgood, 1990     ║
  311.     ║             UNREGISTERED VERSION!           ║
  312.     ╚═════════════════════════════════════════════╝
  313.        
  314.     RIGHT: 0                        WRONG: 0
  315.      
  316.     QUESTION:
  317.     The fascinating fact trivia question will be displayed
  318.     here.
  319.     
  320.     <1> Choice 1                        <2> Choice 2
  321.     <3> Choice 3                        <4> Choice 4
  322.     
  323.              Enter Answer: [ 1 2 3 4 <Q>uit]?
  324.                        
  325.    -----------------------------------------------------------------------
  326.    
  327.    The first randomly choosen trivia question is selected from the data
  328.    file and is displayed to the screen. 
  329.    
  330.       The player makes his selection by entering the corresponding number.
  331.    As the game progresses, SFFCTTRV will provide a running total of the
  332.    correct answers and also of the wrong answers the user has selected
  333.    during the game play.
  334.  
  335.    If the ten second timer should elapse before you respond, SFFCTTRV 
  336.    will count this as a wrong response and add an incorrect answer to 
  337.    the total WRONG answers obtained so far.
  338.            
  339.  
  340.    EXITING PLAY
  341.    ------------
  342.    
  343.       When you are ready to exit the game, simply select press "Q" for
  344.    <Q>uit.  If you qualify as one of the top ten players to date, 
  345.    SFFCTTRV will congratulate you for becoming one of the top ten scorers
  346.    and add your name to the Top Ten listing.  You will once again see the 
  347.    Top Ten list displayed with your name added to the list.  
  348.    
  349.      If you exit the game before you have completed the twenty
  350.    questions required for eligibility to the Top Ten list or if you do not
  351.    qualify as a Top Ten player, the Top Ten listing will be displayed and 
  352.    you will be prompted to press any key to return to SPITFIRE.
  353.    
  354.    
  355.    DISTRIBUTION
  356.    ------------
  357.      
  358.       Please feel free to share SFFCTTRV.ZIP with others.  However, it must
  359.    be distributed with SFFCTTRV.EXE, SFFCTTRV.DAT, SFFCTTRV.TOP, SFFCTTRV.LMT 
  360.    and the SFFCTTRV.DOC in the SFFCTTRV.ZIP distribution package.  The
  361.    files must not be altered in any way or by any means.
  362.    
  363.       SFFCTTRV.ZIP is distributed as Shareware software.  You are free to
  364.    try SFFCTTRV, and if you find it to be a program you use please send the
  365.    required $10.00 fee, for a "Registered" in YOUR name program, to:
  366.    
  367.                              "HOME" BBS   
  368.                              P.O. Box 416
  369.                              Norco, California  91760-0416
  370.  
  371.       with the following information:
  372.  
  373.       Sysop Name:_________________________________________________________
  374.                       As YOU wish it to appear on YOUR registered version 
  375.       BBS Name:___________________________________________________________
  376.     
  377.       BBS Number:(_____)___-_______________ Voice Number:(____)___-_______
  378.     
  379.       Mailing Address:____________________________________________________
  380.  
  381.       City:_____________________________State:___________Zipcode__________
  382.  
  383.       Tell me whether to send a 3.5" or 5.25" disk.
  384.  
  385.       You, in turn, shall receive a Registered version with MORE trivia on
  386.       it with YOUR name and BBS Name showing YOU to be the PROUD owner!
  387.  
  388.                                             And my THANKS!!!                 
  389.                                                                     ENJOY!            
  390.    DISCLAIMER
  391.    ----------
  392.    
  393.       "HOME" BBS shall not be held responsible for any damage incurred
  394.    by the user to hardware, software, or peripheral devices while running
  395.    SFFCTTRV.  All responsibility lies in the user of the software.   
  396.    
  397.    
  398.       Many thanks are indeed owed to Mike Woltz of Buffalo Creek BBS (515)-
  399.    225-8496 for his assistance.  Without his help this program would not
  400.    have been possible.   
  401.    
  402.  
  403.    SFFCTTRV and other SPITFIRE programs are available for download from:
  404.    
  405.         Buffalo Creek BBS                           "HOME" BBS
  406.         Sysop - Mike Woltz                     Sysop - Dr. Feelgood
  407.           (515) 225-8496                         (714) 735-2573
  408.        19200/9600/2400/1200                          2400/1200
  409.  
  410.